home *** CD-ROM | disk | FTP | other *** search
/ Risc World 5 / Risc World 5.iso / SOFTWARE / Issue6 / VICE / VICE.ZIP / doc / vice_3 < prev    next >
Text File  |  2005-01-24  |  4KB  |  174 lines
  1. <HTML>
  2. <HEAD>
  3. <!-- This HTML file has been created by texi2html 1.52
  4.      from ../vice.texi on 23 January 2005 -->
  5.  
  6. <TITLE>VICE Manual - 3  Invoking the emulators</TITLE>
  7. </HEAD>
  8. <BODY>
  9. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_2.html">previous</A>, <A HREF="vice_4.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  10. <P><HR><P>
  11.  
  12.  
  13. <H1><A NAME="SEC20" HREF="vice_toc.html#TOC20">3  Invoking the emulators</A></H1>
  14.  
  15. <P>
  16. The names of the available emulators are:
  17.  
  18. </P>
  19.  
  20. <UL>
  21.  
  22. <LI>
  23.  
  24. <CODE>x64</CODE>, the C64 emulator
  25.  
  26. <LI>
  27.  
  28. <CODE>x128</CODE>, the C128 emulator
  29.  
  30. <LI>
  31.  
  32. <CODE>xvic</CODE>, the VIC20 emulator
  33.  
  34. <LI>
  35.  
  36. <CODE>xpet</CODE>, the PET emulator
  37.  
  38. <LI>
  39.  
  40. <CODE>xplus4</CODE>, the PLUS4 emulator
  41.  
  42. <LI>
  43.  
  44. <CODE>xcbm2</CODE>, the CBM-II emulator
  45.  
  46. </UL>
  47.  
  48. <P>
  49. You can run each of them by simply typing the name from a shell.  If you
  50. want to run them from another application (e.g., a window manager or
  51. some other sort of program launcher) you should always run them from a
  52. terminal window such as <CODE>xterm</CODE> or <CODE>rxvt</CODE> since VICE provides
  53. a lot of debugging information that is sent to the terminal and has
  54. built-in monitor that also appears there.  For example, you could do
  55.  
  56. </P>
  57.  
  58. <PRE>
  59. xterm -e x64
  60. </PRE>
  61.  
  62.  
  63.  
  64. <H2><A NAME="SEC21" HREF="vice_toc.html#TOC21">3.1  Command-line options used during initialization</A></H2>
  65.  
  66. <P>
  67. There are several options you can specify on the command line.  Some of
  68. them are used to specify emulation settings and will be described in
  69. detail later (see section <A HREF="vice_6.html#SEC39">6  Settings and resources</A> for a complete list).  The
  70. remaining options are used only to give usage information or to
  71. initialize the emulator in some way:
  72.  
  73. </P>
  74. <DL COMPACT>
  75.  
  76. <DT><CODE>-help</CODE>
  77. <DD>
  78. <A NAME="IDX6"></A>
  79.  
  80. <A NAME="IDX7"></A>
  81. <DT><CODE>-?</CODE>
  82. <DD>
  83. List all the available command-line options and their meaning.
  84. <A NAME="IDX8"></A>
  85. <DT><CODE>-default</CODE>
  86. <DD>
  87. Set default resources (see section <A HREF="vice_6.html#SEC39">6  Settings and resources</A>).  This will
  88. override all the settings specified before, but not the settings
  89. specified afterwards on the command line.
  90. <A NAME="IDX9"></A>
  91. <DT><CODE>-autostart IMAGE</CODE>
  92. <DD>
  93. Autostart <TT>`IMAGE'</TT> (see section <A HREF="vice_3.html#SEC22">3.2  Autostarting programs from the command-line</A>).
  94. <A NAME="IDX10"></A>
  95. <DT><CODE>-1 NAME</CODE>
  96. <DD>
  97. Attach <TT>`NAME'</TT> as a tape image file.
  98. <A NAME="IDX11"></A>
  99. <DT><CODE>-8 NAME</CODE>
  100. <DD>
  101. <A NAME="IDX12"></A>
  102. <DT><CODE>-9 NAME</CODE>
  103. <DD>
  104. <A NAME="IDX13"></A>
  105. <DT><CODE>-10 NAME</CODE>
  106. <DD>
  107. <A NAME="IDX14"></A>
  108. <DT><CODE>-11 NAME</CODE>
  109. <DD>
  110. Attach <TT>`NAME'</TT> as a disk image to device 8, 9, 10 or 11.
  111. </DL>
  112.  
  113.  
  114.  
  115. <H2><A NAME="SEC22" HREF="vice_toc.html#TOC22">3.2  Autostarting programs from the command-line</A></H2>
  116.  
  117. <P>
  118. It is possible to let the emulator <EM>autostart</EM> a disk or tape image
  119. file, by simply specifying its name as the <EM>last</EM> argument on the
  120. command line, for example
  121.  
  122. </P>
  123.  
  124. <PRE>
  125. x64 lovelygame.x64.gz
  126. </PRE>
  127.  
  128. <P>
  129. will start the C64 emulator, attaching <TT>`lovelygame.x64.gz'</TT> as a
  130. disk image and running the first program on it.  You can also specify
  131. the name of the program on the fisk image by appending a colon
  132. (<SAMP>`:'</SAMP>) the name itself to the argument; for example
  133.  
  134. </P>
  135.  
  136. <PRE>
  137. x64 "lovelygame.x64.gz:run me"
  138. </PRE>
  139.  
  140. <P>
  141. will run the program named <TT>`run me'</TT> on <TT>`lovelygame.x64.gz'</TT>
  142. instead of the first one.
  143.  
  144. </P>
  145. <P>
  146. <A NAME="IDX15"></A>
  147. Using the command-line option <CODE>-autostart</CODE> is equivalent; so the same
  148. result can be obtained with
  149.  
  150. </P>
  151.  
  152. <PRE>
  153. x64 -autostart "lovelygame.x64.gz:run me"
  154. </PRE>
  155.  
  156. <P>
  157. If you specify a raw CBM or P00 file, the emulator will setup the file
  158. system based drive emulation so that it is enabled and accesses the
  159. directory containing the file first.  This is a very convenient way to
  160. start multi-file programs stored in file system directories and not
  161. requiring "true" drive emulation.
  162.  
  163. </P>
  164. <P>
  165. See section <A HREF="vice_5.html#SEC33">5.5  Using disk and tape images</A>. for more information about images and
  166. autostart.
  167.  
  168. </P>
  169.  
  170. <P><HR><P>
  171. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_2.html">previous</A>, <A HREF="vice_4.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  172. </BODY>
  173. </HTML>
  174.